home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir34 / dirutili.zip / DIRUTILY.SCR < prev    next >
Text File  |  1992-07-17  |  63KB  |  1,320 lines
  1. .************************************************************************
  2. .*  DIRUTILY                                                            *
  3. .*                                                                      *
  4. .*                                                                      *
  5. .*  Use BookMaster to print this document.                              *
  6. .*                                                                      *
  7. .*                                                                      *
  8. .************************************************************************
  9. .nameit symbol = version     text = '5.01'
  10. .nameit symbol = pgmsize     text = '60K'
  11. .nameit symbol = proksize    text = '50K'
  12. .nameit symbol = keylen      text = '80'
  13. .nameit symbol = tablelen    text = '150'
  14. .nameit symbol = maxkeys     text = '90'
  15. .nameit symbol = maxpath     text = '128'
  16. .**********************************************************************
  17. .* .nameit symbol = oscommand   text = 'Command.286'
  18. .nameit symbol = oscommand   text = 'Command.Com'
  19. .* .nameit symbol = oscommand   text = 'Cmd.Exe'
  20. .**********************************************************************
  21. .* .nameit symbol = pgmname     text = 'Dirutily.286'
  22. .* .nameit symbol = custname    text = 'Dirucust.286'
  23. .nameit symbol = pgmname     text = 'Dirutily.Exe'
  24. .nameit symbol = custname    text = 'Dirucust.Exe'
  25. .**********************************************************************
  26. :revision id=update run=yes.
  27. .* :rev refid=update.
  28. .* :erev refid=update.
  29. .**********************************************************************
  30. .*
  31. :userdoc sec='IBM Internal Use Only'
  32. :prolog.
  33. :docprof  hyphen=yes
  34.           justify=yes
  35.           layout=1
  36.           ldrdots=yes
  37.           toc=01234.
  38. .***   :gdoc sec='IBM Internal Use Only'
  39. .***   :prolog.
  40. :title.Dirutily
  41. :title.Version &version.
  42. :etitle.
  43. :date.February 27, 1991
  44. :author.Paul W. Berry
  45. :address.
  46. IBM 4680 Store Systems
  47. Dept.F81/Bldg.602
  48. Raleigh
  49. North Carolina
  50. Tie Line 442-5377
  51. BERRYPAU at RALVM0
  52. :eaddress.
  53. :eprolog.
  54. :frontm.
  55. :tipage.
  56. :toc.
  57. :body.
  58. .************************************************************************
  59. :h1 id=aboutdu.About Dirutily
  60. .************************************************************************
  61. :p.Dirutily is a full screen directory file manager.  You can perform
  62. operations of your choice on a set of marked files, or just a single
  63. file.
  64. You can move up and down the directory tree, and load a new directory
  65. from another drive without even leaving the Dirutily program.
  66. :rev refid=update.
  67. The profile can be customized to suit your specific needs, and allows
  68. you to assign up to &maxkeys. key combinations on the keyboard to perform
  69. any operation.
  70. :erev refid=update.
  71. .************************************************************************
  72. :h2 id=highlit.Dirutily Highlights
  73. .************************************************************************
  74. :ul.
  75. :li.Execute any program you select on the files you select
  76. :li.Execute any operating system command from within Dirutily
  77. :rev refid=update.
  78. :li.Change file/sub-directory attributes (Read Only, Hidden, System, and Archive)
  79. :erev refid=update.
  80. :li.Edit files with your favorite editor
  81. :li.Copy files to the path you specify
  82. :li.Delete files/sub-directories
  83. :rev refid=update.
  84. :li.Delete complete sub-directory trees with one key stroke
  85. :erev refid=update.
  86. :li.Move files to the path you specify
  87. :li.Prints the files you select
  88. :li.Sort files by name, extension, date, or size
  89. :li.Display file dates in four different formats
  90. :li.Rename files/sub-directories
  91. :li.Upload files from the PC to the host
  92. :li.Display file times in two different formats
  93. :li.Download files from the host to the PC
  94. :li.Browse files with your favorite browse utility
  95. :li.Display total number of bytes used by the current directory
  96. :li.Plus more . . .
  97. :eul.
  98. .**************************************************************************
  99. :h1 id=sysreq.System Requirements
  100. .************************************************************************
  101. :ul.
  102. :li.IBM PC or PS/2
  103. :li.Hard Disk or Disk drive
  104. :rev refid=update.
  105. :li.70k to 130k of available memory depending on which operating system is being used
  106. :erev refid=update.
  107. :li.Any IBM PC or PS/2 display can be used
  108. :eul.
  109. :h2 id=ossupp.Operating Systems Supported
  110. :ul.
  111. :li.MS/PC Dos version 2.1 or higher
  112. :li.OS/2 version 1.2 or higher
  113. :li.4680 Store Systems operating system
  114. :eul.
  115. .**************************************************************************
  116. :h2 id=osdos.Using Dirutily Under the PC/MS DOS Operating System
  117. .**************************************************************************
  118. :rev refid=update.
  119. Included in this package is an icon file called :hp1.Dirutily.Ico:ehp1..
  120. This icon file can be used with the Microsoft Windows product.
  121. :erev refid=update.
  122. .**************************************************************************
  123. :h2 id=osos2.Using Dirutily Under the OS/2 Operating System
  124. .**************************************************************************
  125. When using Dirutily under the OS/2 operating system, please take note of
  126. the following:
  127. :ul.
  128. :li.Dirutily can be used inside an OS/2 Presentation Manager window, or in full
  129. screen mode.
  130. :li.The Dirutily internal command :hp2.&lbrk.QUIT_IN_DIR&rbrk.:ehp2. is
  131. not supported.
  132. :li.When using Dirutily on the High Performance File System (HPFS),
  133. any file that does not follow the standard DOS naming convention
  134. (i.e. filename.ext) will not be recognized by Dirutily.  Everything will still
  135. operate correctly but those files will not be loaded.
  136. :rev refid=update.
  137. :li.When an error message is displayed that includes a return code value,
  138. you can type in :hp2.HELP ##:ehp2. (where ## is the return code value) at the OS/2
  139. command prompt to get additional information about the error that occurred.
  140. :erev refid=update.
  141. :eul.
  142. .pa
  143. .**************************************************************************
  144. :h2 id=os4680.Using Dirutily Under the 4680 Store Systems Operating System
  145. .**************************************************************************
  146. When using Dirutily under the 4680 Store Systems operating system, please
  147. take note of the following:
  148. :ul.
  149. :li.Dirutily for the 4680 Store Systems operating system can only be obtained
  150. from (BERRYPAU @ RALVM0), just send me a note.
  151. :li.The Dirutily internal command :hp2.&lbrk.QUIT_IN_DIR&rbrk.:ehp2. is
  152. not supported.
  153. :li.You are allowed to use Logical names whenever you are prompted
  154. for a target drive and/or path.  Dirutily will lookup the Logical name
  155. you have entered and replace it with the real name you assigned it.
  156. :li.When you assign a program (like an editor) to one of the user definable
  157. keys in the profile, make sure you append the program name with the :hp2..286:ehp2.
  158. extension.  If the file extension is missing, you may get an operating
  159. system shell error message when invoking that user definable key.
  160. :eul.
  161. .**************************************************************************
  162. :h1 id=qstart.Quick Start
  163. .**************************************************************************
  164. :rev refid=update.
  165. :p.If you are the type that does not like to read documentation, then this
  166. section will give you a quick overview of the Dirutily program and some of
  167. its special features.  Dirutily was designed to be very user friendly, so
  168. minimal documentation has been included.  I suggest you still read the
  169. documentation at your convenience, that way you don't miss any of the features
  170. Dirutily has to offer.
  171. :p.Follow these steps to get started right away:
  172. :ol.
  173. :li.Edit the Dirutily profile called :hp1.Dirutily.Pro:ehp1. with your favorite
  174. editor and read some of the comments to get the basic idea of how the key
  175. assignments and Dirutily built in features work.  The comments in the profile
  176. give a brief explanation of most of the features built into Dirutily.
  177. :li.Add to the definable keys in the profile the names of the programs you
  178. want to be executed when a specific key is pressed.  Pay special attention
  179. to the :hp3.File Name/Path Place Holders:ehp3. and
  180. :hp3.Special Key Definition Options:ehp3., these options are used when
  181. defining a key in the profile.
  182. :li.Once you have made all your changes in the profile, run the :hp1.Dirucust:ehp1.
  183. utility to imbed the profile information into the Dirutily program.
  184. :li.Read the section titled :hp3.Special Features:ehp3. in this document.  This
  185. will explain the many special features Dirutily has to offer.  These special
  186. feature are not documented in the profile.
  187. :li.To start Dirutily, just type in :hp2.DIRUTILY:ehp2. at the operating system
  188. ready prompt.  If you wish to specify only certain files or a certain sub-directory,
  189. see the section titled :hp3.:hdref refid=startdu.:ehp3. for additional information.
  190. :eol.
  191. :p.:hp2.NOTE::ehp2. By looking at some of the example key definitions assigned
  192. in the profile, it will give you a better understanding about the way key
  193. definitions can be used.
  194. :p.That should do it!  If all else fails, read the documentation!
  195. :erev refid=update.
  196. .******************************************************************************
  197. :h1 id=gtstart.Getting Started
  198. .**************************************************************************
  199. :p.There are three files that make up the Dirutily program as follows:
  200. :ul.
  201. :li.:hp2.&pgmname.:ehp2. is the main file you will invoke to start the program.
  202. :li.:hp2.Dirutily.Pro:ehp2. is the profile that contains all the key definitions,
  203. color definitions, help box text, and some miscellaneous program options.
  204. :li.:hp2.&custname.:ehp2. is used to take the information from the profile and
  205. imbed it into the :hp1.&pgmname. :ehp2. file.
  206. :eul.
  207. .**************************************************************************
  208. :h2 id=bbegin.Before You Begin
  209. .**************************************************************************
  210. :h3 id=editpro.Editing The Profile
  211. .************************************************************************
  212. :p.Before you start using the Dirutily program, you need to edit the
  213. :hp1.Dirutily.Pro:ehp1. file and set up the key definitions, color
  214. definitions, and help box to suit your needs.  The profile that is
  215. included in the package has some of the key definitions preset, you
  216. can alter them in any way you wish.  To edit the profile you need to use any
  217. editor or word processor that saves files in a standard Ascii text format.  If
  218. the editor you are using saves files with tab characters to save on
  219. disk space, you need to save the profile with the editor's :hp2.NOTABS:ehp2.
  220. option; Dirutily does not support tab characters in the profile.  If your
  221. not sure if your editor/word processor saves files with :hp2.TAB:ehp2.
  222. characters, go ahead and make your changes to the profile and save it.
  223. Once you run the Dirucust program, it will let you know if
  224. the profile contained any :hp2.TAB:ehp2. characters.
  225. .**************************************************************************
  226. :h3 id=runduc.Running The Dirucust Program
  227. .************************************************************************
  228. :p.Once you have made all your changes to the profile, you can run the
  229. :hp1.&custname.:ehp1. program to update the :hp1.&pgmname.:ehp1.
  230. program.  Type in :hp2.Dirucust:ehp2. at the operating system ready prompt
  231. and then press the enter key (see the section titled :hp3.:hdref refid=ducerrs.:ehp3.
  232. if you encounter any errors while preforming this
  233. step).  Once you get the message saying :hp1.&pgmname.:ehp1.
  234. has been updated successfully, you can begin using the Dirutily program.
  235. Please note, you can rename Dirutily to something shorter if you like, but
  236. when you make changes to the profile, you must rename it back to Dirutily
  237. before you run the Dirucust program to make the updates.
  238. .**************************************************************************
  239. :h3 id=startdu.Starting The Dirutily Program
  240. .************************************************************************
  241. :p.The only file you will need to operate the Dirutily program is the
  242. :hp1.&pgmname.:ehp1. file.  The :hp1.Dirutily.Pro:ehp1. and
  243. :hp1.&custname.:ehp1. file will only be needed if you want to make
  244. new changes in the profile.  When invoking Dirutily, you can specify
  245. the directory you wish to display, it can also be on another drive.
  246. If you do not specify anything, the current directory will be displayed.
  247. You can specify a file name and extension if you want to display certain
  248. types of files.  Wildcard and Global characters are supported in the file name and
  249. extension positions (i.e. * or ?).  The default, if no file name or extension
  250. are specified is :hp2.*.*:ehp2. (all the files in the current directory).
  251. The syntax for Dirutily is very similar to the syntax of the operating system
  252. :hp2.DIR:ehp2. command.
  253. The syntax for Dirutily is:
  254. .sk
  255. :hp2.
  256. .ce DIRUTILY &lbrk.d&colon.&rbrk.&lbrk.path&lbrk.fn.ext&rbrk.&rbrk.
  257. :ehp2.
  258. .sk
  259. The following example displays files in the :hp2.C&colon.\TOOLS:ehp2. directory
  260. meeting the search specifications given below:
  261. :xmp.
  262.   Examples: :hp2.DIRUTILY C&colon.\TOOLS :ehp2.
  263.               (loads all files)
  264.             :hp2.DIRUTILY C&colon.\TOOLS\DIRU*.* :ehp2.
  265.               (files starting with DIRU with any extension)
  266.             :hp2.DIRUTILY C&colon.\TOOLS\DIR?TILY.* :ehp2.
  267.               (ignore 4th character in file name with any extension)
  268. :exmp.
  269. .**************************************************************************
  270. :h1 id=intcmd.Dirutily Internal Commands
  271. .************************************************************************
  272. Dirutily has a set of internal commands that you can assign to the
  273. definable keys in the profile.  Internal commands are enclosed in
  274. square brackets (i.e. :hp2.&lbrk.COPY&rbrk.:ehp2.).
  275. .**************************************************************************
  276. :h2 id=cmddesc.Internal Command Listing and Descriptions
  277. .************************************************************************
  278. :dl tsize=19 termhi=2 headhi=3 break=none.
  279. :dthd.Command Name
  280. :ddhd.Description
  281. .********************
  282. :dt.&lbrk.COPY&rbrk.
  283. :dd.This command copies the current/marked files to the location you specify.
  284. If the location you gave is not a sub-directory, you will be asked if
  285. you want to create the sub-directory.  If you do not have more than one
  286. file marked, you are also given the choice to copy the file under a new
  287. name.
  288. :p.If you select to have the sub-directory created, Dirutily will first
  289. create the new sub-directory and then copy the file to it.
  290. All the file attributes will be preserved.
  291. An :hp2.*:ehp2. can be used as a place holder for the file name or
  292. file extension if you're copying only one file.  If you use the :hp2.*:ehp2.
  293. as a place holder, you will :hp2.ALWAYS:ehp2. be prompted to create
  294. a sub-directory or copy the file under a new name.  Select :hp2.N:ehp2. to
  295. copy under a new name and the substitution will take place.
  296. .sk
  297. :dt.&lbrk.MOVE&rbrk.
  298. :dd.The move command works just like the copy command except the file is
  299. moved and not copied.
  300. Doing a move on the same drive is much faster than doing a copy and then
  301. a delete.
  302. See the :hp1.&lbrk.COPY&rbrk.:ehp1. internal command for additional
  303. information.
  304. .sk
  305. :rev refid=update.
  306. :dt.&lbrk.DELETE&rbrk.
  307. :dd.This command can be used to delete the current file/marked files.
  308. You will be prompted for a :hp2.Y/N:ehp2. response to verify that is what you
  309. intended to do.
  310. If the file is Read Only, (i.e. :hp2.R:ehp2. in the attribute field),
  311. you will be asked a second time to confirm your intention.
  312. .br
  313. To delete a sub-directory, follow these steps:
  314. :ol.
  315. :li.Place the bounce bar on the sub-directory entry you want to delete.
  316. :li.Press the key you assigned the :hp1.&lbrk.DELETE&rbrk.:ehp1. internal
  317. command to.
  318. :eol.
  319. .sk
  320. :hp2.NOTE::ehp2. When deleting a sub-directory, Dirutily will delete all the
  321. files and sub-directories chained off that sub-directory (that includes
  322. Read Only and Hidden files).  This is a big time-saver!
  323. You will always be prompted twice for a :hp2.Y/N:ehp2.
  324. response to verify that is what you intended to do.  While it is deleting the
  325. sub-directory, you can press the :hp2.Esc:ehp2. key to abort the process.
  326. When the sub-directory is being deleted, it will display the total number of
  327. files and directories it is deleting.
  328. :erev refid=update.
  329. .sk
  330. :dt.&lbrk.RENAME&rbrk.
  331. :dd.This command renames the current file/marked files/sub-directory.  Wildcard and
  332. global characters (i.e. :hp2.?:ehp2. and :hp2.*:ehp2.) can be used as place holders when
  333. doing a rename.
  334. The :hp2.*:ehp2. is used to keep the original file name or file extension.
  335. The :hp2.?:ehp2. is used to ignore selected characters in the file name
  336. or file extension.
  337. .sk
  338. :dt.&lbrk.ATTRIB_MENU&rbrk.
  339. :dd.This command displays a menu of file attribute selections.  The following
  340. attributes can be changed on the current file/marked files/sub-directories:
  341. :rev refid=update.
  342. Read Only, Hidden, System, or Archive.
  343. :erev refid=update.
  344. .sk
  345. :dt.&lbrk.PRINT&rbrk.
  346. :dd.This command prints the current file/marked files on the printer, after each file
  347. is printed, a form feed is sent to the printer.
  348. .sk
  349. :dt.&lbrk.QUIT&rbrk.
  350. :dd.This command quits the Dirutily program.
  351. .sk
  352. :dt.&lbrk.QUIT_IN_DIR&rbrk.:fn.Only available under the PC/MS DOS operating system.:efn.
  353. :dd.This command quits the Dirutily program in the directory and drive you are
  354. currently viewing.
  355. .sk
  356. :dt.&lbrk.REFRESH_DIR&rbrk.
  357. :dd.This command refreshes the file listing and screen.  Use this command if
  358. an application program messes up the screen, or you changed diskettes in the
  359. drive and you want to load the new diskette.
  360. .sk
  361. :dt.&lbrk.NEW_PATH&rbrk.
  362. :dd.This command allows you to load a new drive and/or sub-directory.  All the rules
  363. for this feature are the same as the rules when starting the Dirutily program.
  364. You have the option to specify a :hp3.d:\path:ehp3. after the :hp1.&lbrk.NEW_PATH&rbrk.:ehp1.
  365. internal command which will automatically load the :hp3.d:\path:ehp3. once the key you
  366. assigned it is pressed.  If you choose not to specify a :hp3.d:\path:ehp3. after
  367. the :hp1.&lbrk.NEW_PATH&rbrk.:ehp1. internal command, you will be prompted to
  368. enter in the target path.  See the following examples:
  369. :xmp.
  370.   alt_f9  = &lbrk.NEW_PATH&rbrk.
  371.      (prompts you with a command line to enter the target path)
  372.   alt_f10 = &lbrk.NEW_PATH&rbrk. C:\TOOLS
  373.      (loads the :hp2.C:\TOOLS:ehp2. sub-directory)
  374.   alt_f11 = &lbrk.NEW_PATH&rbrk. A:\
  375.      (loads the root directory on the :hp2.A::ehp2. drive)
  376.   alt_f12 = &lbrk.NEW_PATH&rbrk. ..
  377.      (loads the parent directory of the current sub-directory)
  378. :exmp.
  379. .sk
  380. .sk
  381. :rev refid=update.
  382. :dt.&lbrk.SORT_MENU&rbrk.
  383. :dd.This command displays a menu of sorting options, and allows you to
  384. sort the file list by name, extension, size, date, or no sorting at all.
  385. If you select the :hp3.Unsorted:ehp3. option, the file list will be
  386. refreshed and any marked files will be unmarked.
  387. :erev refid=update.
  388. .sk
  389. :dt.&lbrk.SORT_NAME&rbrk.
  390. :dd.This command sorts the file list by name in ascending order.  A short cut
  391. to bypass using the :hp1.&lbrk.SORT_MENU&rbrk.:ehp1. internal command.
  392. .sk
  393. :dt.&lbrk.SORT_EXT&rbrk.
  394. :dd.This command sorts the file list by extension in ascending order.  A short cut
  395. to bypass using the :hp1.&lbrk.SORT_MENU&rbrk.:ehp1. internal command.
  396. .sk
  397. :dt.&lbrk.SORT_SIZE&rbrk.
  398. :dd.This command sorts the file list by size in descending order (largest files
  399. first).  A short cut to bypass using the :hp1.&lbrk.SORT_MENU&rbrk.:ehp1. internal
  400. command.
  401. .sk
  402. :dt.&lbrk.SORT_DATE&rbrk.
  403. :dd.This command sorts the file list by date in descending order (newer files first).
  404. A short cut to bypass using the :hp1.&lbrk.SORT_MENU&rbrk.:ehp1. internal command.
  405. .sk
  406. :dt.&lbrk.MARK_MENU&rbrk.
  407. :dd.This command displays a mark options menu, and allows you to mark/unmark/remark
  408. all the files in the list.
  409. .sk
  410. :dt.&lbrk.UNMARK_ALL&rbrk.
  411. :dd.This command unmarks all the files in the file list.  A short cut to using
  412. the :hp1.&lbrk.MARK_MENU&rbrk.:ehp1. internal command.
  413. .sk
  414. :dt.&lbrk.MARK_ALL&rbrk.
  415. :dd.This command marks all the files in the file list.  A short cut to using
  416. the :hp1.&lbrk.MARK_MENU&rbrk.:ehp1. internal command.
  417. .sk
  418. :dt.&lbrk.REMARK&rbrk.
  419. :dd.This command will re-mark any files that have been processes
  420. (i.e. a * next to the file name).  A short cut to using the
  421. :hp1.&lbrk.MARK_MENU&rbrk.:ehp1. internal command.
  422. .sk
  423. :dt.&lbrk.TOGGLE_HELP&rbrk.
  424. :dd.This command toggles between help screens.
  425. .sk
  426. :dt.&lbrk.OS_SHELL&rbrk.
  427. :dd.This command allows you to leave Dirutily temporarily and return to the operating system.
  428. When you want to return to Dirutily, type :hp2.EXIT:ehp2. at the operating system
  429. prompt and you will be returned to Dirutily where you left off.
  430. :edl.
  431. .**************************************************************************
  432. :h1 id=spcfeat.Special Features
  433. .**************************************************************************
  434. :h2 id=cmdline.Dirutily Command Line
  435. .************************************************************************
  436. :rev refid=update.
  437. :p.The command line allows you to enter information to be passed on
  438. to the operating system.  The information you enter can be used to run
  439. a program against a set of marked files, or just the current file the
  440. bounce bar is sitting on.  What this means is you do not have to assign
  441. a program/utility to a key in the profile just to use it in Dirutily, you
  442. can enter it on the command line and accomplish the same results.
  443. :p.Basically, anything you enter at the operating systems ready prompt can also
  444. be done on the Dirutily command line.  To have the command line appear, you
  445. must assign one of the keys in the profile with the correct option.  See the
  446. section titled :hp3.:hdref refid=keyopts.:ehp3. for
  447. additional information.
  448. :p.The command line is also scroll-able from left to right when editing a
  449. user definable key.
  450. :p.Another nice feature of the command line is you can specify any of the
  451. file name/path place holders when entering a command on the command line.
  452. See the section titled :hp3.:hdref refid=pholder.:ehp3. for
  453. additional information.
  454. :erev refid=update.
  455. .******************************************************************************
  456. :h2 id=crecall.Command Recall
  457. .************************************************************************
  458. :rev refid=update.
  459. :p.The command recall feature allows you to recall previously enter
  460. commands that were entered on the command line.
  461. Each of the items listed below can save their last ten commands entered at
  462. the command line:
  463. :ul.
  464. :li.The :hp2.&lbrk.COPY&rbrk.:ehp2. and :hp2.&lbrk.MOVE&rbrk.:ehp2. internal commands.
  465. Note, these two internal commands share the same stack of commands entered.
  466. :li.The :hp2.&lbrk.RENAME&rbrk. :ehp2. internal command.
  467. :li.The :hp2.&lbrk.NEW_PATH&rbrk. :ehp2. internal command.
  468. :li.Any user definable key you assigned in the profile that allows you to
  469. edit the key definition on the command line.
  470. :eul.
  471. Use the :hp2.Up:ehp2. and :hp2.Down:ehp2. arrow keys to recall the commands
  472. you entered for each of the items listed above.
  473. :erev refid=update.
  474. .************************************************************************
  475. :h2 id=markfil.Marking Files
  476. .************************************************************************
  477. :p.To mark a file, place the bounce bar on the file you wish to mark and
  478. press the :hp2.Space Bar:ehp2..  This will put an arrow next to that
  479. entry.
  480. To unmark a file, do the same thing and the mark will be removed.
  481. Once the marked file is processed, the arrow is changed to a
  482. :hp2.*:ehp2., indicating the file was processed successfully.
  483. A file does not have to be marked to perform an operation on it.  By
  484. placing the bounce bar on a file, it is equivalent to marking just that
  485. one file.
  486. .**************************************************************************
  487. .cp
  488. .************************************************************************
  489. :h2 id=fsearch.Single Key File Search
  490. .************************************************************************
  491. :p.Dirutily has a special feature that allows you to press the first
  492. character on the keyboard of a file name or extension and the bounce bar will be placed
  493. on the first entry in the list beginning with that character.  Each additional
  494. time that character is pressed, you will be placed on the next entry in the
  495. list starting with that character.
  496. :rev refid=update.
  497. :p.If the file list is sorted by file extension, Dirutily will search for the first
  498. character in the file extension, if no more file extensions are found, it will
  499. then begin searching for file names starting with that character.
  500. :erev refid=update.
  501. :p.If the file list is sorted by file name, size, or date, Dirutily will search for the first
  502. character in the file name.
  503. .**************************************************************************
  504. :h2 id=loaddir.Loading New Directories Via The Enter Key
  505. .************************************************************************
  506. :p.When the file list is displayed and the enter key is pressed on a
  507. :hp2.<DIR>:ehp2. entry, that sub-directory will be loaded.
  508. To return to the parent directory, press the enter key on the
  509. :hp2. . . :ehp2. directory entry.  You can also use the internal command
  510. :hp2.&lbrk.NEW_PATH&rbrk.:ehp2. which can be assigned to a key via the profile.
  511. By using the :hp2.&lbrk.NEW_PATH&rbrk.:ehp2. internal command, you can also
  512. load any drive or directory.
  513. .**************************************************************************
  514. :h2 id=abortpr.Aborting a Process
  515. .************************************************************************
  516. :p.The :hp2.Esc:ehp2. key is used to abort a process.  This means that
  517. if you are in the middle of copying ten files and you decide that after
  518. five of the files are copied you want to stop, pressing the
  519. :hp2.Esc:ehp2. key will stop the process.  This
  520. aborting feature can be used on all operations that can be performed on
  521. marked files.  The :hp2.Esc:ehp2. key is also used to quit a process
  522. you are getting ready to perform, which means any time you are
  523. being prompted for input from the keyboard, you can press the
  524. :hp2.Esc:ehp2. key to quit that operation.
  525. .**************************************************************************
  526. :h2 id=dskfull.Handling Disk Full Conditions
  527. .************************************************************************
  528. :p.When copying or moving files to the target drive.  If the disk fills
  529. up and all the files were not processed, Dirutily will try to utilize as
  530. much free space on the disk by looking thru the list of marked files
  531. trying to determine what files will fit in the remaining space that is
  532. available on the target disk.
  533. The files that are skipped will
  534. :hp2.NOT:ehp2. be flagged with a :hp2.*:ehp2., indicating those files were
  535. not processed.  An error message will also appear informing you about the
  536. disk full error.  If a file already exists on the target disk and its size
  537. plus the number of bytes free on the target drive are equal to or greater
  538. than the file being processed, the file will still be processed.
  539. .**************************************************************************
  540. :h1 id=proinfo.Information Concerning The Profile
  541. .************************************************************************
  542. :p.The profile contains key definitions for the keyboard, plus options used
  543. by the Dirutily program.  For any key definition in the profile, you can
  544. specify anything you like after the equal sign.
  545. The number of characters including blanks after the equal sign
  546. cannot exceed &keylen..
  547. .**************************************************************************
  548. :h2 id=comment.Using Comments
  549. .************************************************************************
  550. :rev refid=update.
  551. :ul.
  552. :li.To comment out a complete line, place a blank or an asterisk in
  553. column one.
  554. :xmp.
  555.    *alt_e = edit /       Column one is an asterisk, line ignored.
  556.     alt_e = edit /       Column one is a blank, line ignored.
  557. :exmp.
  558. :li.To comment out only a part of a line, place two asterisks next to
  559. each other.
  560. :xmp.
  561.    alt_e = edit /     ** Only this half of the line is ignored.
  562.    alt_e = edit /     *  This is not a comment, only one asterisk specified.
  563. :exmp.
  564. :li.You are allowed to use asterisks in your key definitions as long as
  565. two asterisks are not right next to each other (i.e. **).
  566. :xmp.
  567.    alt_s   = saveram *.EXE
  568.    alt_f10 = &lbrk.NEW_PATH&rbrk. C:\TOOLS\*.EXE
  569. :exmp.
  570. :eul.
  571. :erev refid=update.
  572. .**************************************************************************
  573. :h2 id=helpbox.Help Boxes
  574. .************************************************************************
  575. :rev refid=update.
  576. :p.Dirutily will allow you to have up to three help boxes defined in the
  577. profile.  Each help box is capable of displaying 33 lines of help text.
  578. The size of the help box will depend on the number of lines/rows your
  579. terminal is set up for.  If your terminal displays 25 lines, then only
  580. 15 lines of help text will be displayed.  If your terminal can display 43
  581. lines, then 33 lines of help text can be displayed.  In other words, the help box
  582. will adjust itself to your terminal size when Dirutily is started.
  583. :erev refid=update.
  584. .**************************************************************************
  585. :h2 id=defkeys.Definable Keys
  586. .************************************************************************
  587. :rev refid=update.
  588. :ul.
  589. :li.Enter
  590. :li.Esc
  591. :li.F1 - F12
  592. :li.Alt+F1 - Alt+F12
  593. :li.Alt+A - Alt+Z
  594. :li.Ctrl+F1 - Ctrl+F12
  595. :li.Ctrl+A - Ctrl+Z
  596. :eul.
  597. :erev refid=update.
  598. .**************************************************************************
  599. :h2 id=uscmds.Using Dirutily Internal Commands
  600. .************************************************************************
  601. :p.When you assign one of the Dirutily's internal commands,
  602. it :hp2.MUST:ehp2. be the only thing specified on that line, with
  603. the exception of the :hp1.&lbrk.NEW_PATH&rbrk.:ehp1. internal command.  See
  604. the following example:
  605. .sk
  606. :hp2.
  607. .ce alt_r = &lbrk.RENAME&rbrk.
  608. :ehp2.
  609. .**************************************************************************
  610. :h2 id=pholder.Using File Name/Path Place Holders
  611. .************************************************************************
  612. :rev refid=update.
  613. For the following examples, assume the current directory is
  614. :hp3.C&colon.\TOOLS:ehp3. and the current file :hp3.MYFILE.DOC:ehp3..
  615. :erev refid=update.
  616. .**************************************************************************
  617. :h3 id=fnhold./n File Name Place Holder
  618. .************************************************************************
  619. :rev refid=update.
  620. :p.The :hp2./n:ehp2. place holder is used to insert the file name only
  621. (not including its extension) anywhere a :hp2./n:ehp2. is found after the equal
  622. sign.  In other words, :hp3.MYFILE:ehp3. will be inserted anywhere a
  623. :hp2./n:ehp2. is found, see the following example:
  624. :xmp.
  625. .ce :hp2.alt_n = CHKNAME C&colon./n :ehp2. gets converted to :hp2.CHKNAME C&colon.MYFILE :ehp2.
  626. :exmp.
  627. :erev refid=update.
  628. .**************************************************************************
  629. :h3 id=fehold./e File Extension Place Holder
  630. .************************************************************************
  631. :rev refid=update.
  632. :p.The :hp2./e:ehp2. place holder is used to insert the file extension only
  633. (not including its file name) anywhere a :hp2./e:ehp2. is found after the equal
  634. sign.  In other words, :hp3.DOC:ehp3. will be inserted anywhere a
  635. :hp2./e:ehp2. is found, see the following example:
  636. :xmp.
  637. .ce :hp2.alt_e = CHKEXT C&colon./e :ehp2. gets converted to :hp2.CHKEXT C&colon.DOC :ehp2.
  638. :exmp.
  639. :erev refid=update.
  640. .**************************************************************************
  641. :h3 id=drvhold./d Drive Place Holder
  642. .************************************************************************
  643. :rev refid=update.
  644. :p.The :hp2./d:ehp2. place holder is used to insert the current drive
  645. letter anywhere a :hp2./d:ehp2. is found after the equal sign.
  646. In other words, :hp3.C&colon.:ehp3. will be inserted anywhere a
  647. :hp2./d:ehp2. is found, see the following example:
  648. :xmp.
  649. .ce :hp2.alt_d = CHKDSK /d :ehp2. gets converted to :hp2.CHKDSK C&colon. :ehp2.
  650. :exmp.
  651. :erev refid=update.
  652. .**************************************************************************
  653. :h3 id=pathold./p Current Path Place Holder
  654. .************************************************************************
  655. :rev refid=update.
  656. :p.The :hp2./p:ehp2. place holder is used to insert the current path
  657. (without its file name and extension) anywhere a :hp2./p:ehp2. is found
  658. after the equal sign.  In other words, :hp3.C&colon.\TOOLS:ehp3. will be
  659. inserted anywhere a :hp2./p:ehp2. is found, see the following example:
  660. :xmp.
  661. .ce :hp2.alt_p = CHKPATH /p :ehp2. gets converted to :hp2.CHKPATH C&colon.\TOOLS:ehp2.
  662. :exmp.
  663. :erev refid=update.
  664. .**************************************************************************
  665. :h3 id=fphold./   Complete File Path Place Holder
  666. .************************************************************************
  667. :rev refid=update.
  668. :p.The :hp2./:ehp2. place holder is used to insert the complete path
  669. including the file name and extension anywhere a :hp2./:ehp2. is found
  670. after the equal sign.  In other words, :hp3.C&colon.\TOOLS\MYFILE.DOC:ehp3.
  671. will be inserted anywhere a :hp2./:ehp2. is found, see the following example:
  672. :xmp.
  673. .ce :hp2.alt_f = PE2 / :ehp2. gets converted to :hp2.PE2 C&colon.\TOOLS\MYFILE.DOC :ehp2.
  674. :exmp.
  675. :erev refid=update.
  676. .*****************************************************************
  677. :h3 id=hostph./h PC or Host File Extension Place Holder
  678. .************************************************************************
  679. :rev refid=update.
  680. :p.The :hp2./h:ehp2. place holder is used to insert the PC or Host file
  681. extension anywhere a :hp2./h:ehp2. is found after the equal sign.
  682. For the following examples, assume the current directory is
  683. :hp3.C&colon.\TOOLS:ehp3. and the current file :hp3.MYFILE.SCT:ehp3..
  684. Assume you had the following pc/host extension tables specified in the profile:
  685. :xmp.
  686.                    set pc_ext_table   =  SCT    EXE    PKG     EXC
  687.                    set host_ext_table =  SCRIPT EXEBIN PACKAGE EXEC
  688. :exmp.
  689. :p.If you had the following user key assigned in the profile:
  690. :xmp.
  691. .ce  alt_u = &lbrk.BO&rbrk.&lbrk.EA&rbrk. MYTECOPY / H&colon./n /h A1  //CK
  692. :exmp.
  693. :p.Once you press :hp2.Alt+U:ehp2., the host file extension :hp3.SCRIPT:ehp3.
  694. will be inserted where the :hp2./h:ehp2. appears in the example shown above.
  695. In other words, the :hp3.SCT:ehp3. is converted to :hp3.SCRIPT:ehp3..
  696. The following line shows you what the command would look like when it is passed
  697. to the operating system to upload the file from the PC to the host:
  698. :xmp.
  699. :hp2.
  700. .ce MYTECOPY C:\TOOLS\MYFILE.SCT H&colon.MYFILE SCRIPT A1 /CK
  701. :ehp2.
  702. :exmp.
  703. :p.The same holds true for downloading files from the host. If you had the
  704. following user key assigned:
  705. :xmp.
  706. .ce  alt_d = &lbrk.BO&rbrk.&lbrk.EA&rbrk. MYTECOPY H&colon./n /h A1  /  //CK
  707. :exmp.
  708. :p.Once you press :hp2.Alt+D:ehp2., the PC file extension :hp3.SCT:ehp3.
  709. will be inserted where the :hp2./h:ehp2. appears in the example shown above.
  710. In other words, the :hp3.SCRIPT:ehp3. is converted to :hp3.SCT:ehp3..
  711. The following line shows you what the command would look like when it is passed
  712. to the operating system to download the file from the host to the PC:
  713. :xmp.
  714. :hp2.
  715. .ce MYTECOPY H&colon.MYFILE SCRIPT A1 C:\TOOLS\MYFILE.SCT /CK
  716. :ehp2.
  717. :exmp.
  718. :p.:hp2.NOTE&colon.:ehp2. If the current file extension is not in one of
  719. the file extension conversion tables, it will be upload/downloaded as is.
  720. See the section titled :hp3.:hdref refid=fetabs.:ehp3. to take
  721. advantage of this feature.
  722. :erev refid=update.
  723. .**************************************************************************
  724. :h2 id=stopsub.Stopping Substitution of File Name/Path Place Holders
  725. .************************************************************************
  726. :p.If you want to use one of the place holders mentioned above,  and you
  727. do not want the substitution to take place, use :hp2.//:ehp2.
  728. (two slashes, i.e. :hp2.//e:ehp2. will show up as :hp2./e:ehp2.  and  :hp2.//:ehp2.
  729. will show up as :hp2./:ehp2.).
  730. .**************************************************************************
  731. .pa
  732. .************************************************************************
  733. :h2 id=keyopts.Using Special Key Definition Options
  734. .************************************************************************
  735. :rev refid=update.
  736. :p.The following key definition options must be specified before
  737. anything else on a key definition line.
  738. Multiple options can be used in any order with :hp2.NO:ehp2. blanks
  739. between them.  Each option is two characters in length, and is enclosed in
  740. square brackets (i.e. :hp2.&lbrk.RF&rbrk.:ehp2.).
  741. :erev refid=update.
  742. .**************************************************************************
  743. :h3 id=eoopt.Using The &lbrk.EO&rbrk. (Edit Once) Profile Option
  744. .************************************************************************
  745. :rev refid=update.
  746. :p.The :hp2.&lbrk.EO&rbrk.:ehp2. option is used when you want to execute something against
  747. all the marked files in the list :hp2.WITHOUT:ehp2. stopping between each one.
  748. When using the :hp2.&lbrk.EO&rbrk.:ehp2. option, the command line will appear before the first
  749. marked file is processed, allowing you to make changes to the line before
  750. it is passed to the operating system to be executed.  If you specified any
  751. file name place holder options mentioned above, once you press the enter
  752. key, all the substitutions will take place.  So what ever was on the command
  753. line when you press the enter key, will be passed to the operating system to
  754. be executed against all the marked files in the list.  For example,
  755. if in the profile you specified the following key definition to upload files:
  756. :xmp.
  757. .ce alt_u = &lbrk.EO&rbrk. MYTECOPY / H:/n /e A1 //CK
  758. :exmp.
  759. Once you press :hp2.Alt+U:ehp2., everything after the :hp2.&lbrk.EO&rbrk.:ehp2. sign on the
  760. line above will be displayed on
  761. the command line.  This line says to upload all the marked files to your :hp2.A1:ehp2.
  762. disk on the host.  If you wanted to change it to upload to your :hp2.B1:ehp2.
  763. disk, you would change the :hp2.A1:ehp2. to a :hp2.B1:ehp2. on the command
  764. line.  For example, if the current directory is :hp3.C&colon.\TOOLS:ehp3. and the marked file
  765. we are processing is :hp3.MYFILE.DOC:ehp3., once you press the enter key, the
  766. following line will be passed to the operating system to be executed:
  767. :xmp.
  768. .ce :hp2.MYTECOPY C&colon.\TOOLS\MYFILE.DOC H&colon.MYFILE DOC B1 /CK :ehp2.
  769. :exmp.
  770. Each marked file will be inserted where :hp3.MYFILE.DOC:ehp3. is shown above.
  771. Now lets say you have a bunch of script files you want to upload to the host.
  772. When the command line appears, replace the :hp2./e:ehp2. with the
  773. name :hp3.SCRIPT:ehp3. and all the marked files will be uploaded with a file
  774. type of :hp3.SCRIPT:ehp3..  See the following example:
  775. :xmp.
  776. .ce :hp2. MYTECOPY / H:/n /e A1 //CK :ehp2.
  777. .sk
  778. .ce you would change the :hp2./e:ehp2. to :hp2.SCRIPT:ehp2.
  779. .sk
  780. .ce :hp2. MYTECOPY / H:/n SCRIPT A1 //CK :ehp2.
  781. .sk
  782. .ce once you press enter, it will be converted to
  783. .sk
  784. .ce :hp2.MYTECOPY C&colon.\TOOLS\MYFILE.DOC H&colon.MYFILE SCRIPT A1 /CK :ehp2.
  785. :exmp.
  786. :erev refid=update.
  787. .**************************************************************************
  788. :h3 id=eaopt.Using The &lbrk.EA&rbrk. (Edit All) Profile Option
  789. .************************************************************************
  790. :rev refid=update.
  791. :p.The :hp2.&lbrk.EA&rbrk.:ehp2. option is used when you want to execute something against
  792. all the marked files in the list, but :hp2.STOPPING:ehp2. between each one to
  793. allow you to edit the command line before it is processed.
  794. If you specified any file name place holder options mentioned above, all the
  795. substitutions will take place :hp2.BEFORE:ehp2. the command line is displayed.
  796. What ever is on command line when you press the enter key, will be passed to
  797. the operating system to be executed against the current marked file.
  798. For example, if in the profile you specified the following key definition
  799. to upload files:
  800. :xmp.
  801. .ce alt_u = &lbrk.EA&rbrk. MYTECOPY / H&colon./n /e A1 //CK
  802. :exmp.
  803. If the current directory is :hp3.C&colon.\TOOLS:ehp3. and the marked file
  804. we are processing is :hp2.MYFILE.DOC:ehp2., once you press the :hp2.Alt+U:ehp2.
  805. key, the following line will appear on the command line:
  806. :xmp.
  807. .ce :hp2.MYTECOPY C&colon.\TOOLS\MYFILE.DOC H&colon.MYFILE DOC A1 //CK :ehp2.
  808. :exmp.
  809. Any changes you make to the command line will :hp2.ONLY:ehp2. effect the current
  810. marked file.  You can change anything you like on the command line.  You can also
  811. use any of the file name place holder options mentioned above, and once you press
  812. the enter key, all the substitutions will take placed.
  813. :erev refid=update.
  814. .**************************************************************************
  815. :h3 id=rfopt.Using The &lbrk.RF&rbrk. (ReFresh screen) Profile Option
  816. .************************************************************************
  817. :rev refid=update.
  818. :p.The :hp2.&lbrk.RF&rbrk.:ehp2. option will cause the Dirutily screen to be refresh
  819. after the command assigned to the key pressed has completed executing.
  820. This option should be used when you assign a program to a key, and that program
  821. takes over the screen (e.g. like an editor).
  822. :erev refid=update.
  823. .**************************************************************************
  824. :h3 id=propt.Using The &lbrk.PR&rbrk. (Pause Return) Profile Option
  825. .************************************************************************
  826. :rev refid=update.
  827. :p.The :hp2.&lbrk.PR&rbrk.:ehp2. option will cause the operating system to pause
  828. before returning to the Dirutily program, thus allowing you to press any key
  829. when you are ready to return.
  830. This option allows you to see the results/output of program before returning to
  831. Dirutily.  The screen will not be cleared as it processes each marked file
  832. in the list.
  833. :erev refid=update.
  834. .**************************************************************************
  835. :h3 id=paopt.Using The &lbrk.PA&rbrk. (Pause After) Profile Option
  836. .************************************************************************
  837. :rev refid=update.
  838. :p.The :hp2.&lbrk.PA&rbrk.:ehp2. option will cause the operating system to pause after
  839. it processes a file, thus allowing you to press any key when you are ready
  840. to continue.  Once you press any key, the screen will be cleared and processing
  841. will begin on the next marked file in the list.  This option allows you to see the
  842. results/output of program before processing begins on the next marked file in the
  843. list.
  844. :erev refid=update.
  845. .**************************************************************************
  846. :h3 id=pbopt.Using The &lbrk.PB&rbrk. (Pause Before) Profile Option
  847. .************************************************************************
  848. :rev refid=update.
  849. :p.The :hp2.&lbrk.PB&rbrk.:ehp2. option will cause the operating system to pause before
  850. it processes a file, thus allowing you to see the command being passed to the
  851. operating system before it is processed.  Once you press any key to continue,
  852. processing will begin on the file.  Once the file has been processed, the
  853. screen will be cleared.
  854. :erev refid=update.
  855. .**************************************************************************
  856. :h3 id=boopt.Using The &lbrk.BO&rbrk. (Binary Option) Profile Option
  857. .************************************************************************
  858. :rev refid=update.
  859. :p.The :hp2.&lbrk.BO&rbrk.:ehp2. option is used to append a :hp2./B:ehp2. to the end
  860. of a command you assigned to a profile key definition.
  861. This is used for PC to Host and Host to PC file transfer programs.
  862. In the profile there is a list of binary extensions, if the file
  863. extension you are uploading/downloading is in the list of binary
  864. extensions, a :hp2./B:ehp2. will be appended to the command line,
  865. indicating the :hp3.BINARY:ehp3. option is to be used for the file
  866. transfer.
  867. :erev refid=update.
  868. .**************************************************************************
  869. :h3 id=imopt.Using The &lbrk.IM&rbrk. (Ignore Marked files) Profile Option
  870. .************************************************************************
  871. :rev refid=update.
  872. :p.The :hp2.&lbrk.IM&rbrk.:ehp2. option is used to ignore any marked files in the
  873. file list and just execute the program against the current file only.
  874. I assign this option to a browse utility, which allows me to move down
  875. the list looking inside files and marking the ones I want to perform
  876. some operation on without causing all the marked files to be executed.
  877. :erev refid=update.
  878. .cp
  879. .**************************************************************************
  880. :h2 id=proopts.Special Profile Options
  881. .************************************************************************
  882. :h3 id=binext.Specifying Binary File Extensions
  883. .************************************************************************
  884. :p.You can specify a list of file extensions for files that need to be
  885. upload/download in binary.
  886. :rev refid=update.
  887. The length of this file extension list cannot exceed &tablelen. characters.
  888. In order to have this feature work, you must specify the :hp2.&lbrk.BO&rbrk.:ehp2.
  889. :hp3.Special Key Definition Option:ehp3. when assigning the key in the profile.
  890. :erev refid=update.
  891. .**************************************************************************
  892. :h3 id=safcopy.Safe Copy and Move Option
  893. .************************************************************************
  894. :p.If you want to be warned before overwriting an existing file, specify
  895. :hp2.Y:ehp2. for the :hp3.safe_copy_move:ehp3. option in the profile.
  896. .**************************************************************************
  897. :h3 id=dvolid.Displaying The Disk Volume Label
  898. .************************************************************************
  899. :p.To display the disk volume label if it exists, specify a :hp2.Y:ehp2.
  900. for the :hp3.display_volid:ehp3. option in the profile.
  901. .**************************************************************************
  902. :h3 id=defsort.Specifying Default File List Sorting
  903. .************************************************************************
  904. :p.You can specify the type of sorting to be done when Dirutily is loaded:
  905. :ul.
  906. :li.0 = No sorting
  907. :li.1 = Sort by name in ascending order
  908. :li.2 = Sort by extension in ascending order
  909. :li.3 = Sort by size in descending order (largest files first)
  910. :li.4 = Sort by time and date in descending order (newer files first)
  911. :eul.
  912. .**************************************************************************
  913. :h3 id=dirpos.Specifying Sub-Directory <DIR> Positions In The File List
  914. .************************************************************************
  915. :p.You can specify where you want the sub-directory <DIR> entries to be
  916. placed in the file list:
  917. :ul.
  918. :li.0 = Do not display sub-directories
  919. :li.1 = Allows the sub-directories to be mixed with the file entries
  920. :li.2 = Positions all the sub-directories at the beginning of the file list
  921. :li.3 = Positions all the sub-directories at the end of the file list
  922. :eul.
  923. .**************************************************************************
  924. :h3 id=timefmt.Specifying The File List Time Format
  925. .************************************************************************
  926. :p.You can display files with times displayed in 12 hour or 24 hour
  927. format:
  928. :ul.
  929. :li.1 = 12 hour clock
  930. :li.2 = 24 hour clock
  931. :eul.
  932. .**************************************************************************
  933. :h3 id=datefmt.Specifying The File List Date Format
  934. .************************************************************************
  935. :p.You can display files with dates displayed in 4 different types of
  936. formats:
  937. :ul.
  938. :li.1 = month/day/year
  939. :li.2 = day/month/year
  940. :li.3 = year/month/day
  941. :li.4 = day.month.year
  942. :eul.
  943. .**************************************************************************
  944. :h3 id=bepdone.Beeping The Speaker After Processing The Last Marked File
  945. .************************************************************************
  946. :rev refid=update.
  947. :p.To cause a beep from the speaker to occur after the last marked file has
  948. been processed, specify a :hp2.Y:ehp2. for the :hp3.beep_when_done:ehp3.
  949. option in the profile.  The tone emitted from the speakers has a different
  950. tone than the tone used for Dirutily error indications.
  951. :erev refid=update.
  952. .**************************************************************************
  953. :h3 id=disphid.Displaying Hidden Files/Sub-Directories
  954. .************************************************************************
  955. :rev refid=update.
  956. :p.By default, hidden files and sub-directories will be displayed.  If you
  957. choose not to display the hidden files and sub-directories, specify a :hp2.N:ehp2.
  958. for the :hp3.display_hidden_files:ehp3. option in the profile.
  959. :erev refid=update.
  960. .**************************************************************************
  961. :h3 id=cgasnow.Fast Screen Updates on a CGA Display
  962. .************************************************************************
  963. :rev refid=update.
  964. :p.To speed up the screen updates on a CGA display, specify a :hp2.N:ehp2.
  965. for the :hp3.cga_snow_removal:ehp3. option in the profile.  Note, this will
  966. cause flickering (snow) to occur each time the display is written to.
  967. :erev refid=update.
  968. .**************************************************************************
  969. :h3 id=kbtype.Selecting Keyboard Type
  970. .************************************************************************
  971. :rev refid=update.
  972. :p.If you are using an enhanced keyboard (i.e. 12 function keys),
  973. specify a :hp2.Y:ehp2. for the :hp3.enhanced_keyboard:ehp3. option in the
  974. profile.  Otherwise select :hp2.N:ehp2..  If you start Dirutily and your
  975. system begins to beep and the keyboard locks-up, change this option and
  976. see if that corrects the problem.
  977. :erev refid=update.
  978. .**************************************************************************
  979. :h3 id=fetabs.Setting Up PC/Host File Extension Conversion Tables
  980. .************************************************************************
  981. :p.With the following conversion tables, you can set up a list of PC file
  982. extension which will get mapped to a list of host file extensions
  983. during uploads and downloads to and from the Host.  What this means is
  984. when you are uploading a file to the Host, if the PC file extension is in
  985. the :hp3.pc_ext_table:ehp3., it will be uploaded
  986. with the corresponding Host file extension in the :hp3.host_ext_table:ehp3..
  987. :p.For example, if you have a PC file with an extension of :hp2.SCT:ehp2., when
  988. you upload
  989. the file to the host, the host file extension will be converted to
  990. :hp2.SCRIPT:ehp2..
  991. :rev refid=update.
  992. Each table cannot exceed &tablelen. characters in length.
  993. See the following examples:
  994. :xmp.
  995. :hp2.
  996.           set pc_ext_table   =  SCT    EXE    PKG     EXC  COM    NOT  XED
  997.           set host_ext_table =  SCRIPT EXEBIN PACKAGE EXEC COMBIN NOTE XEDIT
  998. :ehp2.
  999. :exmp.
  1000. :erev refid=update.
  1001. :p.Given the conversion tables shown above, see following examples:
  1002. :xmp.
  1003. :hp2.
  1004. .ce MYFILE.SCT will be uploaded as MYFILE SCRIPT
  1005. .ce MYFILE SCRIPT will be downloaded as MYFILE.SCT
  1006. :ehp2.
  1007. :exmp.
  1008. :p.To take advantage of this feature, you must specify the :hp2.
  1009. :hdref refid=hostph.:ehp3. where ever you
  1010. want the file extension substitution to take place.
  1011. .***********************************************************************
  1012. :h1 id=errmsgs.Error Messages
  1013. .************************************************************************
  1014. :rev refid=update.
  1015. :p.These are the Dirutily and Dirucust error messages displayed when an error
  1016. occurs.
  1017. :p.When an error message is displayed, if a return code value is also displayed
  1018. with the message, this value is an operating system error number.  If you need
  1019. additional information about the error, look-up that return code in your
  1020. operating systems manual.
  1021. :erev refid=update.
  1022. .************************************************************************
  1023. :h2 id=duerrs.Dirutily Error Messages
  1024. .************************************************************************
  1025. :dl tsize='0' break.
  1026. .********************
  1027. :rev refid=update.
  1028. .********************
  1029. :dt.Access Was Denied - Press Any Key
  1030. :dd.Possible errors:
  1031. :ul.
  1032. :li.The file/directory is currently in use by another process.
  1033. :li.The files Read-Only attribute is set.
  1034. :eul.
  1035.  
  1036. .********************
  1037. :dt.Disk Full, All Files Not Copied/Moved - Press Any Key
  1038. :dd.Insufficient disk space available on the target drive.
  1039. See the :hdref refid=dskfull. section of this
  1040. document for additional information.
  1041.  
  1042. .********************
  1043. :dt.Diskette Is Write Protected - Press Any Key
  1044. :dd.Remove the write protect tab from the diskette and try again.
  1045.  
  1046. .********************
  1047. :dt.Drive Not Ready - Press Any Key
  1048. :dd.Make sure a diskette is in the drive and the drive door is closed.
  1049.  
  1050. .********************
  1051. :dt.Error While Accessing I/O Device - Press Any Key
  1052. :dd.Possible errors:
  1053. :ul.
  1054. :li.The hardware device your trying to access was invalid/not
  1055. available/not ready.
  1056. :li.The device had a read/write error.
  1057. :eul.
  1058.  
  1059. .********************
  1060. :dt.Error While Changing File Attributes - Press Any Key
  1061. :dd.The operating system would not let the file attributes be altered.  The
  1062. file could be in use by another process.
  1063.  
  1064. .********************
  1065. :dt.Error While Copying File - Press Any Key
  1066. :dd.Possible errors:
  1067. :ul.
  1068. :li.A disk read/write error occurred.
  1069. :li.Target disk may be bad.
  1070. :li.File is corrupted.
  1071. :li.Not enough memory available to create a copy buffer.
  1072. :li.The file is being used by another process.
  1073. :eul.
  1074.  
  1075. .********************
  1076. :dt.Error While Creating Directory - Press Any Key
  1077. :dd.The operating system would not allow the sub-directory to be
  1078. created, a file may already exist with the same name.
  1079.  
  1080. .********************
  1081. :dt.Error While Deleting Directory - Press Any Key
  1082. :dd.Possible errors:
  1083. :ul.
  1084. :li.A file in the sub-directory may be in use by another process.
  1085. :li.The sub-directory may be in use by another process.
  1086. :eul.
  1087.  
  1088. .********************
  1089. :dt.Error While Deleting File - Press Any Key
  1090. :dd.The operating system would not allow the file to be deleted.
  1091. The file may be in use by another process.
  1092.  
  1093. .********************
  1094. :dt.Error While Getting Console/Environment Information
  1095. :dd.For an unknown reason, the screen/keyboard configuration could not
  1096. be obtained from the operating system.
  1097.  
  1098. .********************
  1099. :dt.Error While Moving File - Press Any Key
  1100. :dd.See :hp3."Error While Copying File - Press Any Key":ehp3. message
  1101. for possible errors.
  1102.  
  1103. .********************
  1104. :dt.Error While Opening File/Printer - Press Any Key
  1105. :dd.The operating system would not allow that file/device to be opened
  1106. for reading/writing.  The file/device could be in use by another process.
  1107.  
  1108. .********************
  1109. :dt.Error While Printing File - Press Any Key
  1110. :dd.Possible errors:
  1111. :ul.
  1112. :li.Printer out of paper.
  1113. :li.Printer is off line.
  1114. :li.Printer turned off.
  1115. :eul.
  1116.  
  1117. .********************
  1118. :dt.Error While Renaming File - Press Any Key
  1119. :dd.Possible errors:
  1120. :ul.
  1121. :li.The new file name you specified may have already existed.
  1122. :li.The new file name you specified may have contained invalid characters.
  1123. :li.The file is currently being used by another process.
  1124. :eul.
  1125.  
  1126. .********************
  1127. :dt.File Already Exists - Press Any Key
  1128. :dd.The target file already exists in the path you specified.
  1129.  
  1130. .********************
  1131. :dt.File Cannot Be Copied/Moved To Itself - Press Any Key
  1132. :dd.You cannot copy or move a file to itself.  Check your target path and
  1133. try again.
  1134.  
  1135. .********************
  1136. :dt.Insufficient Memory Available - Press Any Key
  1137. :dd.The operation you were trying to perform could not allocate adequate
  1138. memory to perform the operation.  Free up some memory and try again.
  1139.  
  1140. .********************
  1141. :dt.Invalid Directory
  1142. :dd.The directory name you specified does not exist or is not a valid
  1143. directory name.
  1144.  
  1145. .********************
  1146. :dt.Invalid Drive Was Specified - Press Any Key
  1147. :dd.The target drive you specified was invalid, check the target drive and
  1148. try again.
  1149.  
  1150. .********************
  1151. :dt.I/O Device Read/Write Failure - Press Any Key
  1152. :dd.Possible errors:
  1153. :ul.
  1154. :li.Target diskette may be bad.
  1155. :li.Target diskette is not formatted.
  1156. :li.Printer is not turned on.
  1157. :li.Device is currently in use by another process.
  1158. :eul.
  1159.  
  1160. .********************
  1161. :dt.Key Not Defined In The Profile
  1162. :dd.The key you pressed has not been defined in the Dirutily.Pro file.
  1163. Once you add the key definition, you must run the Dirucust program to
  1164. take the contents of the profile and imbed it into the Dirutily
  1165. program.
  1166.  
  1167. .********************
  1168. :dt.No File(s) Found
  1169. :dd.Could not find any files matching the file specification you
  1170. specified.  If any sub-directory entries existed, they will still be
  1171. displayed.
  1172.  
  1173. .********************
  1174. :dt.Not Enough Memory Available To Load Files
  1175. :dd.Your system did not have adequate memory available to load the
  1176. directory list.  Free up some memory and try again.
  1177.  
  1178. .********************
  1179. :dt.Not Enough Memory, List Not Complete - Press Any Key
  1180. :dd.There was inadequate memory available to load all the files in the
  1181. directory you specified.
  1182.  
  1183. .********************
  1184. :dt.Operating System Shell Error - Press Any Key
  1185. :dd.Possible errors:
  1186. :ul.
  1187. :li.Could not find :hp3.&oscommand.:ehp3. command processor.
  1188. :li.Inadequate memory available to load a new copy of the operating system command processor.
  1189. :li.The program you are trying to execute is missing its file extension.  Add
  1190. the file extension to the program you specified in the profile and
  1191. re-run the Dirucust program.
  1192. :eul.
  1193.  
  1194. .********************
  1195. :dt.Source File Error While Copying File - Press Any Key
  1196. :dd.See :hp3."Error While Copying File - Press Any Key":ehp3. message
  1197. for possible errors.
  1198.  
  1199. .********************
  1200. :dt.Source File Error While Moving File - Press Any Key
  1201. :dd.See :hp3."Error While Copying File - Press Any Key":ehp3. message
  1202. for possible errors.
  1203.  
  1204. .********************
  1205. :dt.Target File Error While Copying File - Press Any Key
  1206. :dd.See :hp3."Error While Copying File - Press Any Key":ehp3. message
  1207. for possible errors.
  1208.  
  1209. .********************
  1210. :dt.Target File Error While Moving File - Press Any Key
  1211. :dd.See :hp3."Error While Copying File - Press Any Key":ehp3. message
  1212. for possible errors.
  1213.  
  1214. .********************
  1215. :dt.Target Path Length Is Too Long - Press Any Key
  1216. :dd.The target path cannot exceed &maxpath. characters in length.
  1217.  
  1218. :edl.
  1219. :erev refid=update.
  1220. .pa
  1221. .**************************************************************************
  1222. :h2 id=ducerrs.Dirucust Error Messages
  1223. .************************************************************************
  1224. :dl tsize='0' break.
  1225. .********************
  1226. :rev refid=update.
  1227.  
  1228.  
  1229. .********************
  1230. :dt.Cannot open &pgmname. in the current directory
  1231. :dd.Dirutily.Pro and the Dirutily program must reside in the same
  1232. directory.  This error will also occur if Dirutily is being used by
  1233. another process.
  1234.  
  1235. .********************
  1236. :dt.Could not free up memory
  1237. :dd.The operating system would not allow the memory buffers to be freed.
  1238.  
  1239. .********************
  1240. :dt.Dirutily.Pro cannot contain Tab characters
  1241. :dd.The profile contained tab characters.  Make sure the editor you used
  1242. to update the profile saved it without inserting tab characters.
  1243. The profile should an option to save files without inserting tab
  1244. characters (e.g. :hp2.save filename.ext notabs:ehp2.).
  1245.  
  1246. .********************
  1247. :dt.Dirutily.Pro must be smaller than &proksize.
  1248. :dd.The profile is too large, remove some blank lines or comment lines.
  1249.  
  1250. .********************
  1251. :dt.Dirutily.Pro not found in current directory
  1252. :dd.The Dirutily.Pro and the Dirutily program must reside in the same
  1253. directory when running the Dirucust program.
  1254.  
  1255. .********************
  1256. :dt.Error occurred while closing Dirutily.Pro
  1257. :dd.The operating system would not allow the profile to be closed.
  1258.  
  1259. .********************
  1260. :dt.Error occurred while reading in &pgmname.
  1261. :dd.Possible errors:
  1262. :ul.
  1263. :li.A disk read error occurred while reading in the Dirutily program.
  1264. :li.&pgmname. is being used by another process, close the other process
  1265. and try again.
  1266. :eul.
  1267.  
  1268. .********************
  1269. :dt.Error occurred while writing to &pgmname.
  1270. :dd.Possible errors:
  1271. :ul.
  1272. :li.A disk write error occurred while writing to the Dirutily program.
  1273. :li.&pgmname. is being used by another process, close the other process and
  1274. try again.
  1275. :li.&pgmname. has the Read Only file attribute set.  Change the file attribute
  1276. and try again.
  1277. :eul.
  1278.  
  1279. .********************
  1280. :dt.Make sure &pgmname. and &custname. have the same version number
  1281. :dd.The Dirutily and Dirucust programs must be at the same version
  1282. level.
  1283.  
  1284. .********************
  1285. :dt.Not enough memory to load in &pgmname.
  1286. :dd.You must have at least &pgmsize. bytes of memory available to update
  1287. the Dirutily program.
  1288.  
  1289. .********************
  1290. :dt.Not enough memory to load in Dirutily.Pro
  1291. :dd.You must have at least &proksize. bytes of memory free before
  1292. running the Dirucust program.
  1293.  
  1294. .********************
  1295. :dt.Problem occurred while trying to update &pgmname.
  1296. :dd.An unknown error occurred while trying to update the profile
  1297. information inside of the Dirutily program.
  1298.  
  1299. .********************
  1300. :dt.There was an error while reading in Dirutily.Pro
  1301. :dd.A read error occurred while trying to read the profile into memory.
  1302. Obtain a new copy of Dirutily.Pro and try again.
  1303.  
  1304. .********************
  1305. :dt.This is a duplicate profile entry
  1306. :dd.You have a duplicate profile entry, remove the duplicate entry and try again.
  1307.  
  1308. .********************
  1309. :dt.This profile entry is invalid
  1310. :dd.The line could not be recognized by the Dirucust program.
  1311.  
  1312. .********************
  1313. :dt.This profile entry is too long
  1314. :dd.The line displayed was too long, the maximum line size of a profile
  1315. entry is &keylen. characters in length.
  1316.  
  1317. :edl.
  1318. :erev refid=update.
  1319. :egdoc.
  1320.